home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / internet-tools / pong11 / pong.readme < prev    next >
Encoding:
Text File  |  1996-02-26  |  2.6 KB  |  69 lines
  1. Short: network host monitor
  2. Type: comm/net
  3. Uploader: mlelstv@serpens.rhein.de
  4. Author: mlelstv@serpens.rhein.de
  5.  
  6. pong is a utility that monitors the presence of hosts on the net
  7. using the ICMP ECHO protocol (aka 'ping').
  8.  
  9. History:
  10.  
  11. After we got private access to the internet we had to fight many
  12. problems with unstable software and modems or ISDN links suddenly
  13. dropping connections.
  14. I wrote a shell script that pinged a couple of strategic hosts and
  15. routers. When a host answered a ping it was considered 'up', otherwise
  16. 'down' and a change in state was reported with the say command.
  17. This way I was alerted when there was a problem even when I was busy
  18. with other things.
  19.  
  20. This script was started every few minutes by DCron (from Matt Dillon).
  21. This had the disadvantage that every few minutes a program used the
  22. hard disk, trashed SnoopDos output and slowed other programs down.
  23.  
  24. pong does basically the same as the monitoring script. It takes a
  25. list of hosts from a configuration file, tries to ping these and
  26. report state changes on standard output. The messages are also read
  27. from the configuration file. You can redirect the messages to SPEAK:
  28. for audible reports or pipe the output to a shell so that any command
  29. can be executed when a host becomes reachable or unreachable.
  30.  
  31. pong runs in infinite loop. You have to abort it with ctrl-c or
  32. the BREAK command.
  33.  
  34. Usage:
  35.  
  36. pong CONFIG/A,CHECK/K/N,RETRY/K/N,PRESET/S,TO/K:
  37.  
  38. CONFIG/A       the name of the configuration file
  39. CHECK/K/N  n   recheck a host every n seconds that was found alive
  40.                the default is 300 seconds
  41. RETRY/K/N  n   if a host does not reply in n seconds it is considered down
  42.                the default is 30 seconds
  43. PRESET/S       do not report the initial state of each host
  44. TO/K           the name of a redirection file. Only status messages are
  45.                sent to that file. A shell redirection would also send
  46.                possible error messages.
  47.  
  48. The config file is a sequence of lines that are also parsed with ReadArgs.
  49. The template is:
  50.  
  51. HOST/A,UP/K/A,DOWN/K/A,CHECK/K/N,RETRY/K/N
  52.  
  53. HOST/A     is the name of IP number of the host.
  54. UP/K/A     is the string to be printed when the host becomes alive
  55. DOWN/K/A   is the string to be printed when the host becomes unreachable
  56. CHECK/K/N  and
  57. RETRY/K/N  are optional CHECK and RETRY settings for this host that override
  58.            the command line parameters
  59.  
  60. pong is written for the AS225 TCP/IP protocol stack. It should also work
  61. with the socket.library emulation from Henning Schmiedehausen and AmiTCP.
  62.  
  63. Changes:
  64.  
  65. 1.1    considers a host down if a ping fails twice in a row. This
  66.        avoids messages if a packet is lost on transit.
  67.  
  68. Michael van Elst
  69.